home *** CD-ROM | disk | FTP | other *** search
/ MacSilverWare / macsilverware.iso / Utilities / Calculator II / Calculator II 1.23 ReadMe < prev    next >
Text File  |  1993-09-09  |  10KB  |  145 lines

  1. Calculator II ReadMe
  2. 9 September 1993
  3. Copyright © 1991-93, Joe Cicinelli.
  4. All Rights Reserved.
  5.  
  6. This program is FREEware and may not be sold or distributed without the permission of the author.  This application was developed with Symantec C++ 6.0 so portions of the product are copyrighted by the Symantec Corporation.
  7.  
  8. The author, Joe Cicinelli, makes no warranties, either express or implied, regarding the fitness of the Calculator II application for any particular purpose.  Use it at your own risk.  The author claims no liability for data loss or other problems caused directly or indirectly by the Calculator II application.
  9.  
  10.  
  11. Purpose:
  12.  
  13. Calculator II is a pleasant looking color multi-function calculator that runs as an application under system 6.x or System 7.  The calculator was written as an application to be run under MultiFinder or System 7 alongside other applications.  It improves on Apple’s original calculator by adding trigonometric functions, functions for base 10 and natural logorithms and their inverses, hex-to-decimal and decimal-to-hex conversion, a percent increase/decrease key, a memory function for storing values across uses of the program, and all of these functions can be invoked by using the F-Keys on the Apple Extended keyboard (F5 - F15).  The calculator also allows users to correct trailing digits of values entered on the display of the calculator through the use of a backspace key.  A Ticker Tape is also provided to display the results of past calculations.  Balloon help and general information about the program is available under either the Help menu under System 6.x or the Balloon Help menu under System 7.  This software is being distributed as FREEware so give it a try and let me know what you think!
  14.  
  15. This version of the calculator contains several bug fixes and enhancements:
  16. • Fixed a couple of Balloon Help bugs that caused balloons to appear or not appear at inappropriate times.
  17. • Numbers copied to the clipboard from the calculator’s display no longer contain leading spaces.
  18. • The calculator no longer permits the errant factorial calculations of negative numbers and 0.
  19. • Fixed a bug using the HEX and DEC keys successively to convert numbers between hexadecimal and decimal.
  20. • Changed the creator of the Calculator to ‘calc’ from ‘CALC’ to make accessing its bundle more realiable.
  21. • The Calculator now saves its preferences in a Prefs File rather than inside itself.  This will permit future updates of the program with Updaters like UpdateMaker.
  22. • A new Info item was added to the Help Menu to thank all the people that have helped to make Calculator II a success.
  23.  
  24. This application has been explicitly tested under Systems 6.0.7, 7.0 (with and without System 7 Tuneup 1.1.1), and 7.1 with the Hardware Enablers.  Testing was performed using a IIcx, Classic, Quadra 700, and PowerBooks 165c, 170 and Duo 230.  Previous versions have run successfully on LCs and SE/30s.
  25.  
  26.  
  27. Calculator Capabilities:
  28.  
  29. 1. Trigonometric functions (sin, cosine, tangent, arcsin, arccos, & arctangent).
  30. 2. Base 10 and Natural logarithms and their inverse functions.
  31. 3. Square and Square root functions.
  32. 4. Conversion from HEX numbers to decimals and vice versa.  NOTE: HEX values must be entered in uppercase only and cannot exceed the value 0xFFFFFFFF.
  33. 5. Power and nth root functions.
  34. 6. Ability to correct trailing digits of values being entered on the calculator’s display.
  35. 7. Support for complete operation of calculator functions via the Apple Extended Keyboard (F5 - F15 required).
  36. 8. Ability to cut, copy and paste to and from the clipboard.
  37. 9. Balloon help is available for menus, About Dialog box, calculator keys, and the icon in the Finder.
  38. 10. General information about the program (Calculator II ReadMe document) is also available under the Help menu under Systems 6.0.x or 7.
  39. 11. Calculator remembers last used position on screen.
  40. 12. Shift key can be used with function and Clear keys to execute 2nd functions (e.g. arcsin instead of sin).  When used with the Clear key only the last entry is cleared and not the entire equation.  Likewise, the shift key can also be used with the mouse to access the 2nd Functions.
  41. 13. Calculator II retains the contents of its memory across uses of the program.
  42. 14. Calculator is AppleEvent aware of the core suite of events.
  43. 15. Through the use of the percent key, it is now possible to calculate percent increase or decrease.  For example, it is now possible to enter 5 - 3.2% = 4.84!  The percent key can also be used with a number to divide by 100 as in 5% = .05.
  44. 16. Ticker tape can be displayed by selecting Show Ticker Tape under the Edit menu to capture a history of performed calculations.  Contents of tape may also be copied to the clipboard for use in another application.
  45.  
  46.  
  47. Keyboard Map for Function Keys:
  48.  
  49. The function keys that appear on the calculator are mapped to the Function keys F5 - F15 on the Apple Extended Keyboard.  Here is the correspondence map:
  50.  
  51. F5=sin
  52. F6=cosine
  53. F7=tangent
  54. F8=2nd Function
  55. F9=Value of PI
  56. F10=Natural Log
  57. F11=Base 10 Log
  58. F12=Backspace Key
  59. F13=Power function
  60. F14=Square root function
  61. F15=Square function
  62.  
  63. Shift + F5=arc sin
  64. Shift + F6=arc cosine
  65. Shift + F7=arc tangent
  66. Shift + F9=Factorial function
  67. Shift + F10=Constant e raised to a power.
  68. Shift + F11=Constant 10 reaised to a power.
  69. Shift + F13=Nth Root function
  70. Shift + F14=Cubed Root function
  71. Shift + F15=expression 1 divided by x
  72.  
  73. Other keys mapped to functions on the calculator:
  74. c, Clear=Clear function
  75. ESC = (Same as Clear/No Function)***
  76. *, x=Multiplication
  77. X=Memory Enter
  78. R=Memory Recall
  79. M=Memory Add
  80. ?=About Dialog box
  81. Delete=Backspace function
  82. Enter=Equal function
  83. ` or . = Reverse sign of number on display***
  84. % = Percent increase or decrease.
  85.  
  86. Shift + Clear or Esc = Clear Last Entry, not just last digit.
  87. Clear + X = Clear Memory.
  88. 2nd Decimal point in any number = reverse sign of number ***
  89.  
  90. ***Depends upon settings in Preferences Dialog Box.
  91.  
  92.  
  93. Future Plans for Calculator II:
  94. 1. Force Calculator to solve equations using the standard Hierarchy of Operators.
  95. 2. Option to display commas every 3 digits in results window.
  96. 3. Switch to display Statistical, Business, Scientific, or Programmer functions.
  97. 4. Option to display negative numbers in red color or parentheses instead of with leading negative sign.
  98. 5. Allow for the print and save (TEXT) of the ticker tape.
  99.  
  100.  
  101. Correspondence:
  102.  
  103. I can be reached by U.S mail at:
  104. Joseph G. Cicinelli
  105. 4477 West Taro Drive
  106. Glendale, AZ  85308
  107. (602) 581-3865
  108.  
  109. I can also be reached electronically at:
  110. cicinell@saifr00.ateng.az.honeywell.com
  111.  
  112.  
  113. Bibliography:
  114. 1. Andrews, M. (1991).  Programmer’s Guide to MPW, Volume 1.  Reading, Mass:  Addison-Wesley Publishing Company, Inc.
  115. 2. Andrews, M. & Rhodes, N. (1992).  Programmer’s Guide to MPW, Volume 2.  Reading, Mass:  Addison-Wesley Publishing Company, Inc.
  116. 3. Apple Computer, Inc. (1985-91).  Inside Macintosh, vol. I-VI.  Reading, Mass:  Addison-Wesley Publishing Company, Inc.
  117. 4. Apple Computer, Inc. (1988).  Inside Macintosh X-Ref.   Reading, Mass:  Addison-Wesley Publishing Company, Inc.
  118. 5. Apple Computer, Inc. (1990).  ResEdit Reference.  Reading, Mass:  Addison-Wesley Publishing Company, Inc.
  119. 6. Chernicoff, S. (1985). Macintosh Revealed, Programming With the Toolbox, vol 2.  Hasbrouck Heights, NJ:  Hayden Book Company.
  120. 7. Chernicoff, S. (1985). Macintosh Revealed, Unlocking the Toolbox, vol 1.  Hasbrouck Heights, NJ:  Hayden Book Company.
  121. 8. Chernicoff, S. (1989). Macintosh Revealed, Mastering the Toolbox, vol 3.  Hasbrouck Heights, NJ:  Hayden Book Company.
  122. 9. Chernicoff, S. (1990). Macintosh Revealed, Expanding the Toolbox, vol 4.  Hasbrouck Heights, NJ:  Hayden Book Company.
  123. 10. Ellis, M. A., & Stroustrup, B. (1990).  The Annotated C++ Reference Manual.  Reading, Mass:  Addison-Wesley Publishing Company, Inc.
  124. 11. Huxham, F. A., Bernard, D., & Takatsuka, J. (1989).  Using the Macintosh Toolbox With C.  San Francisco, CA:  SYBEX Inc.
  125. 12. Kernighan, B. W., & Ritchie, D. M. (1988).  The C Programming Language.  Englewood Cliffs, NJ:  Prentice Hall.
  126. 13. Knaster, S. (1988).  Macintosh Programming Secrets.  Reading, Mass:  Addison-Wesley Publishing Company, Inc.
  127. 14. Knaster, S., & Rollin, K. (1992).  Macintosh Programming Secrets (2nd Ed).  Reading, Mass:  Addison-Wesley Publishing Company, Inc.
  128. 15. Little, G., & Swihart, T. (1991).  Programming for System 7.  Reading, Mass:  Addison-Wesley Publishing Company, Inc.
  129. 16. Mark, D. (1990).  Macintosh C Programming Primer, vol 2.  Reading, Mass:  Addison-Wesley Publishing Company, Inc.
  130. 17. Mark, D., & Reed, C. (1989).  Macintosh Programming Primer.  Reading, Mass:  Addison-Wesley Publishing Company, Inc.
  131. 18. Müldner, T., & Steele, P. W. (1988).  C as a Second Language.  Reading, Mass:  Addison-Wesley Publishing Company, Inc.
  132. 19. Stroustrup, B. (1987).  The C++ Programming Language.  Reading, Mass:  Addison-Wesley Publishing Company, Inc.
  133. 20. Surovell, D. A., Hall, F. M., & Othmer, K. (1992).  Programming Quickdraw™:  Includes Color Quickdraw™ and 32-Bit Quickdraw™.  Reading, Mass:  Addison-Wesley Publishing Company, Inc.
  134.  
  135.  
  136. Many Thanks!
  137.  
  138. Jerry Klorman:  For the many subtle spelling errors you have caught and called to my attention and the constructive comments you have offered to make the interface better.
  139.  
  140. Richard Darling:  For your kind words of encouragement, colorful printouts, and new feature suggestions.  Hope the percent key helps!
  141.  
  142. Warren Hensel:  Nothing can replace lifetime friendship and the encouragement you have offered over the years.
  143.  
  144. To everybody that has sent in a shareware payment as a form of encouragement even though one was not required.  You are the people that make the shareware vision work!
  145.